home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / u_man / cat1 / ipaste.z / ipaste
Encoding:
Text File  |  1998-10-20  |  6.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. IIIIPPPPAAAASSSSTTTTEEEE((((1111GGGG))))                                                          IIIIPPPPAAAASSSSTTTTEEEE((((1111GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ipaste - display an image
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      iiiippppaaaasssstttteeee [[[[----ffff]]]] [[[[----nnnn]]]] [[[[----ssssxxxx]]]] [[[[----oooo xxxxoooorrrrgggg yyyyoooorrrrgggg]]]] iiiimmmmggggffffiiiilllleeee
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _i_p_a_s_t_e is a utility that displays images stored using the image library
  16.      "libimage.a".  _i_p_a_s_t_e reads pixel values, image dimensions and other
  17.      relevant data from the file _i_m_g_f_i_l_e via calls to the image library.
  18.      _i_p_a_s_t_e then displays the image in a window.  On machines with few bit
  19.      planes, _i_p_a_s_t_e dithers the image.
  20.  
  21.      The ----ffff option causes _i_p_a_s_t_e to run in the foreground.  Normally, _i_p_a_s_t_e
  22.      forks off a background process to display the image while the foreground
  23.      process exits back to the command line.  With this option the image is
  24.      displayed by the foreground process.
  25.  
  26.      The ----nnnn option pastes the image without any window manager border.  When
  27.      the image is viewed in this way, access to the window frame and its
  28.      buttons is disabled as the frame itself is not visible.  However the X
  29.      window menu can still be popped up under 4Dwm by pressing the left Ctrl-
  30.      Shift keys simultaneously and then RIGHTMOUSE when the cursor is on top
  31.      of the image.  The Minimize/Stow and Quit menu items give the same
  32.      results as the control buttons on the visible window frame.  Moving the
  33.      image around can still be accomplished via the Move menu item, or by
  34.      pressing down the left Ctrl-Shift keys simultaneously, then pressing
  35.      MIDDLEMOUSE, and then moving the mouse.
  36.  
  37.      The ----ssssxxxx option pastes the image with a white border or frame surrounding
  38.      it in the style of a Polaroid SX (TM) photograph.  This option, like ----nnnn,
  39.      disables the window manager border.
  40.  
  41.      The ----oooo xxxxoooorrrrgggg yyyyoooorrrrgggg option automatically pastes the image at a position on
  42.      the screen (absolute screen coordinates) that has as its origin (xorg,
  43.      yorg).
  44.  
  45.      Pressing the EEEEsssscccc key on the keyboard will automatically quit out of
  46.      _i_p_a_s_t_e now.  This is a nice short-cut when the image you are viewing is
  47.      borderless (i.e. has been pasted up using the ----nnnn option).  However, due
  48.      the way the Xserver works with auto-repeat keys on the keyboard (like
  49.      Esc), _i_f you hold down the Escape key too long, and your current _i_p_a_s_t_e
  50.      window has another _i_p_a_s_t_e window underneath it, you will now find the
  51.      second _i_p_a_s_t_e window will also exit.  Be careful when you use the "Esc"
  52.      key shortcut.
  53.  
  54.      In the world of X, the easiest way to get access to the 4Dwm window
  55.      manager menu while over an _i_p_a_s_t_e window (or any GL client)--so you can
  56.      quit out of _i_p_a_s_t_e in this fashion--is to press either "Alt" key and then
  57.      press RIGHTMOUSE.  This is the easiest way to stow, or iconize the image
  58.      and the safest way to quite out of a _i_p_a_s_t_e'd borderless window.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. IIIIPPPPAAAASSSSTTTTEEEE((((1111GGGG))))                                                          IIIIPPPPAAAASSSSTTTTEEEE((((1111GGGG))))
  71.  
  72.  
  73.  
  74.      The four arrow keys (LEFTARROWKEY, DOWNARROWKEY, RIGHTARROWKEY,
  75.      UPARROWKEY) can now be used to scoot the _i_p_a_s_t_e window to the left, down,
  76.      right, or up as long as the cursor is on top of the _i_p_a_s_t_e window when
  77.      you press one of these keys.
  78.  
  79.      Caution:  _i_p_a_s_t_e will NOT work with image files made using the old gl
  80.      program _d_i_t_h_e_r.  For these dithered types of images (8 bits deep) you
  81.      will need to first use _f_r_o_m_d_i to convert them from dithered into RGB
  82.      format, and then can use _i_p_a_s_t_e to display them.  _f_r_o_m_d_i._c lives in
  83.      /_u_s_r/_p_e_o_p_l_e/_4_D_g_i_f_t_s/_i_r_i_s_t_o_o_l_s/_i_m_g_t_o_o_l_s, and the executable is in the
  84.      moregltools subsystem on the EOE2 software product.
  85.  
  86. NNNNOOOOTTTTEEEESSSS
  87.      On machines having less than 24 bits available for RGB display, the
  88.      displayed image may appeared to have lost some quality. This occurs when
  89.      the image that was saved was in colormap mode. The pixel color index is
  90.      expanded into the full RGB information. When redisplayed, the RGB
  91.      information is dithered on these machines to approximate the original
  92.      image.
  93.  
  94.      Under 4Dwm there is a constraint on the minimum width a window can have.
  95.      This affects users of ipaste(1G) who try to view image files which have
  96.      an xsize of less than 75 pixels.  Quoting from the "OSF/Motif
  97.      Programmer's Guide", Version 1.1, Section 11.4.2.3, The Title Bar:
  98.  
  99.      The title bar, which may include a title area, window menu button, and
  100.      minimize and maximize buttons, is constrained so that all components in
  101.      the title bar are always visible.  This necessitates a minimum frame size
  102.      and, by extension, a minimum size for your application's window.  The
  103.      size of the components in the title bar depends upon the size of the font
  104.      you choose for the title area text.
  105.  
  106.      As a user shrinks your client window horizontally, space is removed from
  107.      the title area first.  As the window is resized smaller, title text is
  108.      clipped from the right.  The absolute minimum size of the title bar is
  109.      equal to the size of the buttons in the title bar, plus a title area
  110.      equivalent to the width of one title bar button.
  111.  
  112.      The standard minimum-width window size in 4Dwm is 100 pixels.  This is
  113.      based on the fact that SGI's buttons (which live in the area of the title
  114.      bar) are 25 pixels wide.  The min size is calculated to be "buttonSize *
  115.      4" (assuming the buttons are of uniform size). Since _i_p_a_s_t_e has no
  116.      "maximize" button, the min size is "buttonSize * 3".
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.